📊 KPI Principali Visualizzabili

1. Coverage Nazionale:
• 124 Centrali distribuite su 3 macro-aree
• Densità per area: applica filtro Area per valutare bilanciamento
• Identificazione zone sotto-servite

2. Salute Operativa Rete:
• % Collegamenti ATTIVI vs totale
• Collegamenti in fase progettuale (IN_ATTIVAZIONE + IN_VARIAZIONE)
• Collegamenti critici (NON_ATTIVO, IN_REINSTRADAMENTO)

3. Progetti in Corso:
• Filtra per "IN_ATTIVAZIONE" → vedi pipeline nuovi collegamenti
• Filtra per "IN_VARIAZIONE" → vedi upgrade/modifiche
• Filtra per "IN_REINSTRADAMENTO" → vedi ottimizzazioni routing

4. Distanze e Topologia:
• 8.024,40 km totali di fibra/collegamenti
• Usa "Selezione Attuale" per subset di interesse
• Confronta distanze tra scenari alternativi

📊 Analisi Comparativa Multi-Periodo

Obiettivo: Tracciare crescita e evoluzione rete nel tempo
Metodo: Confronta snapshot Rev7.x vs Rev6.x
• Conta nuovi collegamenti aggiunti
• Identifica collegamenti dismessi
• Valuta crescita km fibra totali
• Analizza shift geografico investimenti
Valore: ROI tracking, forecast budget futuro

🔍 Identificazione Colli di Bottiglia

Obiettivo: Trovare single points of failure nella topologia
Metodo:
• Seleziona una zona strategica (es: RM per Lazio)
• Conta quante centrali hanno solo 1-2 collegamenti
• Verifica ridondanza: esistono percorsi alternativi?
• Se centrale ha 1 solo link = SPOF identificato
Azione: Prioritizza investimento in ridondanza

💰 Cost-Benefit Analysis Nuovo Collegamento

Obiettivo: Valutare ROI per proposto nuovo link
Dati Necessari:
• Distanza nuova tratta (usa 📏 sulla mappa)
• Centrali attualmente servite da quella tratta
• Traffic volume potenziale (dato esterno)
Calcolo Rough:
• CAPEX fibra ≈ €20.000-50.000/km (medio)
• Latency risparmiata = (old_distance - new_distance) / 200.000 km/s
Decisione: Se riduzione latency >2ms E traffic >10Gbps → probabile GO

📐 Calcolo Densità di Rete

Formula: Densità = Numero Collegamenti / Numero Centrali
Valore Ideale: 2.5-3.5 (rete ben connessa con ridondanza)
NAT RC_Italia: 330/124 = 2.66 (buona densità)
Uso: Valuta singole zone: se <2.0 = sotto-connessa

🌐 Network Resilience Index

Definizione: % centrali con ≥2 collegamenti
Come Calcolare:
1. Seleziona tutte le centrali
2. Per ognuna, conta collegamenti (visibile in lista)
3. Conta centrali con degree ≥2
4. Resilience = (Centrali con ≥2 link / Totale centrali) × 100
Target: >85% per rete robusta

📡 Struttura Dati Collegamenti

Campi Disponibili per Ogni Link:
• id: Identificativo univoco numerico (integer)
• from / from_id: ID centrale di partenza
• to / to_id: ID centrale di arrivo
• from_name / to_name: Nomi testuali centrali
• distance_km: Distanza in km (float, precisione 2 decimali)
• stato: Enum [ATTIVO, NON_ATTIVO, IN_ATTIVAZIONE, IN_VARIAZIONE, IN_REINSTRADAMENTO]
• zona: Codice zona (string, 2 caratteri)
• regione: Nome esteso regione
• area: Enum [NORD, CENTRO, SUD]
• arco: Segmento di rete (opzionale)
Formato Storage: Array JavaScript nativo per performance

📍 Struttura Dati Centrali/Nodi

Campi per Ogni Nodo:
• id: Identificativo univoco (string/integer)
• name: Nome completo centrale
• clli: Common Language Location Identifier (standard ITU-T)
• lat: Latitudine (float, formato Decimal Degrees, 6 decimali)
• lon: Longitudine (float, formato Decimal Degrees, 6 decimali)
• zona: Codice zona regionale
• area: Macro-area di appartenenza
• TipoSede: Classificazione sede (Tipo 1/2/3)
Precisione Coordinate: ±11cm con 6 decimali

🌍 Formula Haversine - Distanza Geodetica

Uso: Calcolo distanza "as the crow flies" tra due punti su sfera
Formula Completa:
a = sin²(Δφ/2) + cos(φ1) × cos(φ2) × sin²(Δλ/2)
c = 2 × atan2(√a, √(1−a))
d = R × c
Dove:
• φ = latitudine (in radianti)
• λ = longitudine (in radianti)
• R = raggio terrestre = 6371 km
• Δφ = φ2 − φ1
• Δλ = λ2 − λ1
Errore: <0.5% per distanze <1000km
Implementazione: Funzione JavaScript nativa nell'applicazione

🚗 OSRM Routing - Distanza Stradale

Engine: Open Source Routing Machine v5.x
Database: OpenStreetMap con update mensili
Algoritmo: Contraction Hierarchies per performance
Query: HTTP GET a endpoint OSRM pubblico
Response Time: <500ms tipico per query EU
Precisione: ±2-5% vs distanze reali misurate
Limitazioni:
• Solo strade carrozzabili (no sentieri, private roads in alcuni casi)
• Route optimization basato su tempo, non shortest path puro
• Può differire da GPS turn-by-turn moderni

📐 Strumento Misura Manuale (Ruler Tool)

Attivazione: Click icona 📏 in barra controlli mappa
Procedura:
1. Tool attivato: cursore cambia in crosshair
2. Click primo punto sulla mappa
3. Appare marker iniziale
4. Click secondo punto
5. Linea rossa tratteggiata collega i punti
6. Popup mostra distanza in km
7. Opzionale: click punti aggiuntivi per polilinea
Cancellazione: Click icona 🗑️ per rimuovere tutte le misure
Precisione: Equivalente a Haversine (±0.5%)
Limiti: No automatic snapping a nodi/link

🎯 Misura Automatica tra Centrali Selezionate

Metodo:
1. Seleziona centrale A nella lista Centrali
2. Seleziona centrale B nella lista Centrali
3. Click collegamento che li unisce (se esiste)
4. Distanza mostrata in popup e in tabella
Alternativa per Centrali Non Direttamente Collegate:
• Usa Ricerca Centrali Vicine da centrale A
• Output include distanza a tutte le centrali limitrofe
• Nessuna se B non è tra le top 3 → usa ruler tool manuale

⚡ Calcolo Latenza Fibra Ottica

Formula Base:
Latency (ms) = (Distance km / Speed km/s) × 1000
Velocità Luce in Fibra:
• Vuoto: c = 299.792 km/s
• Fibra SMF (G.652): v ≈ 200.000 km/s (⅔ c, indice rifrazione n≈1.5)
Esempio:
Distanza ROMA-MILANO ≈ 480 km (aerea)
Latency teorica = 480 / 200.000 × 1000 = 2.4 ms
Latency Reale: +0.5-1ms per commutazione, repeater, connettori
Budget Link: Tipico RTT (Round Trip Time) = latency × 2

📡 Calcolo Attenuazione Fibra

Formula:
Attenuation (dB) = α × Distance (km) + Connectors + Splices
Valori Tipici:
• Fibra SMF G.652 @ 1550nm: α = 0.2-0.25 dB/km
• Connettori: 0.3-0.5 dB ciascuno
• Splice fusion: 0.05-0.1 dB ciascuno
Esempio ROMA-MILANO 480km:
Fibra: 480 × 0.22 = 105.6 dB
Connettori (2): 2 × 0.4 = 0.8 dB
Splice (10 ogni 50km): 10 × 0.08 = 0.8 dB
Totale Link Budget: ~107 dB
Margin: Se Tx=+3dBm, Rx sensitivity=-30dBm → disponibili 33dB → NON sufficiente! → Necessari amplificatori EDFA

🌐 Calcolo Capacità Spettrale DWDM

Canali ITU-T G.694.1 C-band: 80 canali @ 50GHz spacing
Singolo Canale: 100 Gbps tipico (coherent optics)
Capacità Totale Fibra: 80 × 100 = 8 Tbps (8.000 Gbps)
Con Tecnologia Attuale (400G channels):
80 × 400 = 32 Tbps potential
Uso Pratico:
• Calcola quante fibre necessarie per traffic forecast
• Esempio: serve 20 Tbps? → Minimo 3 fibre @ 8Tbps (con margin)

📊 Quick Reference - Conversioni e Costanti

Conversioni Distanza:
• 1 km = 0.621371 miles
• 1 mile = 1.60934 km
Conversioni Coordinate:
• 1 grado latitudine ≈ 111 km
• 1 grado longitudine ≈ 111 km × cos(latitudine)
• 1' (arc minute) ≈ 1.852 km
• 1" (arc second) ≈ 30.9 metri
Costanti Fibra:
• Velocità luce vuoto: 299.792.458 m/s
• Velocità fibra SMF: ~200.000 km/s
• Attenuazione tipica @ 1550nm: 0.22 dB/km
• Dispersione cromatica SMF: ~17 ps/(nm·km)

✅ Checklist Pre-Intervento

1. Localizza la Centrale Target:
• Cerca nome centrale in tabella "Centrali / Nodi"
• Click per visualizzare posizione esatta su mappa
• Verifica coordinate GPS (LAT/LON)
• Copia coordinate per inserimento in navigatore

2. Identifica Collegamenti Coinvolti:
• Filtra tabella Collegamenti per nome centrale
• Nota tutti i link connessi a quella sede
• Verifica quali sono ATTIVI vs quali in lavorazione
• Stampa/salva screenshot per riferimento offline

3. Pianifica Accesso:
• Usa "🏢 Centrali Vicine" inserendo indirizzo di partenza
• Clicca "Mostra percorso" per routing stradale
• Nota distanza e tempo stimato
• Verifica se serve 4x4 per percorsi di montagna

4. Verifica Situazione Locale:
• Zoom su centrale con livello massimo (18)
• Osserva edifici circostanti, strade, accessi
• Identifica parcheggio potenziale
• Screenshot della zona per riferimento

🧭 Navigazione in Tempo Reale

Con Dispositivo Mobile (Tablet/Smartphone):
• Apri NAT RC_Italia nel browser mobile
• Concedi permessi di localizzazione al browser
• La mappa mostra la tua posizione attuale
• Usa "Centrali Vicine" dalla tua posizione live
• Vedi le 3 centrali più prossime in real-time
Offline Fallback:
• Pre-carica pagina NAT RC_Italia quando hai connessione
• Mappa base rimane in cache browser
• Dati centrali sono embedded (no richieste server)
• Funzioni base (zoom, misura) operative offline

🔍 Verifica On-Site

Conferma di Essere nel Posto Giusto:
1. Apri app GPS (es: Google Maps) sul telefono
2. Leggi coordinate attuali
3. Confronta con coordinate centrale in NAT RC_Italia
4. Se match entro 50-100 metri → sei nel posto corretto
5. Se discrepanza >500m → ricontrolla indirizzo
Troubleshooting Posizione Errata:
• Possibile errore dati: segnala a coordinamento
• Usa ricerca indirizzo inversa per verifica
• Chiedi conferma via radio/telefono a control room

📲 Ottimizzazione per Tablet/Smartphone

Performance:
• Chiudi altre app per liberare RAM
• Usa WiFi quando disponibile (più veloce di 4G per OSRM routing)
• Se lento: deseleziona "Mostra Marker Centrali" per ridurre rendering
Batteria:
• Riduci luminosità schermo
• Disattiva GPS quando non necessario
• Chiudi tab browser non usati
Connettività:
• Pre-carica mappa con WiFi prima di partire
• Screenshot delle zone di lavoro per backup offline
• Salva coordinate critiche in note del telefono

🗺️ Integrazione con Altri Tool GPS

Export Coordinate per Nav Externa:
1. Click centrale target in NAT RC_Italia
2. Leggi coordinate LAT/LON dal popup o tabella
3. Copia coordinate
4. Apri Google Maps / Waze / TomTom
5. Incolla coordinate in search bar (formato: 41.9028, 12.4964)
6. App naviga verso quel punto
Formato Universale: Decimal Degrees (DD) funziona su tutte le app
Alternative: Se app richiede DMS, usa convertitore in NAT RC_Italia

❓ Troubleshooting Guide

Problema: "Non Trovo la Centrale X"
• Verifica spelling: usa ricerca parziale (es: "MIL" per Milano)
• Prova con CLLI invece di nome
• Controlla filtri: se Area SUD attivo, centrali NORD sono nascoste
• Reset All e riprova

Problema: "Mappa Non Si Carica"
• Verifica connessione internet (tiles da OpenStreetMap)
• Refresh page (F5 o pull-to-refresh su mobile)
• Clear cache browser
• Prova browser alternativo (Chrome vs Firefox)

Problema: "Coordinate Sembrano Sbagliate"
• Verifica formato: LAT deve essere ~37-47 per Italia
• LON deve essere ~7-18 per Italia
• Se LAT/LON invertiti: swap manualmente
• Se coordinate tipo "N 41° 54' 10"" → convert to DD first

Problema: "Percorso Stradale Non Disponibile"
• OSRM potrebbe essere offline (temporaneo)
• Fallback: usa distanza aerea × 1.3 come stima
• Usa Google Maps routing come alternativa
• Report issue a team sviluppo

Stati Disponibili e Uso

• 🟢 ATTIVO - Collegamenti operativi normali. Default: ON
  Quando deselezionare: Per focus solo su problemi/progetti
• 🔴 NON_ATTIVO - Collegamenti disattivati o fuori servizio. Default: ON
  Quando selezionare solo questo: Audit impianti dismessi, verifica asset
• 🟡 IN_ATTIVAZIONE - Collegamenti in fase commissioning. Default: ON
  Quando selezionare solo questo: Monitoring progetti, tracking timeline
• 🟠 IN_VARIAZIONE - Upgrade o modifiche tecniche in corso. Default: ON
  Quando selezionare solo questo: Identificare link a rischio per maintenance window
• 🔵 IN_REINSTRADAMENTO - Migrazione traffico attiva. Default: ON
  Quando selezionare solo questo: Track operazioni di rete ottimization

3 Macro-Aree

• NORD - Include zone: PV, LO, LI, NE, ER
  Copertura: Piemonte, Valle d'Aosta, Lombardia, Liguria, Trentino, Veneto, Friuli, Emilia Romagna
• CENTRO - Include zone: TO, MU, RM, AM
  Copertura: Toscana, Marche, Umbria, Lazio, Abruzzo, Molise
• SUD - Include zone: CB, SA, PU, CA, SI
  Copertura: Campania, Basilicata, Puglia, Calabria, Sicilia, Sardegna

Zone Disponibili (Codici a 2 Lettere)

NORD: PV (Piemonte/VdA) • LO (Lombardia) • LI (Liguria) • NE (Nord-Est) • ER (Emilia Romagna)
CENTRO: TO (Toscana) • MU (Marche/Umbria) • RM (Lazio) • AM (Abruzzo/Molise)
SUD: CB (Campania/Basilicata) • SA (Sardegna) • PU (Puglia) • CA (Calabria) • SI (Sicilia)

Bottoni Veloci

• Tutti: Seleziona istantaneamente tutte le 14 zone
  Uso: Ripristino visibilità completa dopo filtro specifico
• Nessuno: Deseleziona tutte le zone
  Uso: Base per selezione negativa (rimuovi tutto, poi aggiungi solo quelle volute)

Struttura Archi

Concetto: Gli archi rappresentano raggruppamenti logici di collegamenti per scopo infrastrutturale.
Esempi Tipici:
• Arco_Dorsale_Nord: Collegamenti backbone area settentrionale
• Arco_Anello_RM: Anello metropolitano Roma
• Arco_Interconnessione_EU: Link transfrontalieri
Numero Archi: Variabile (dipende da architettura rete)

Come Usare

1. Espandi lista archi disponibili
2. Seleziona/deseleziona checkbox per arco specifico
3. Solo collegamenti appartenenti ad archi selezionati sono visibili
4. Usa "Tutti"/"Nessuno" per controllo rapido
Combinazione con Altri Filtri: Arco + Stato + Area = filtro ultra-specifico

Componenti Tabella

• Contatore: Mostra "X / Y" dove X=selezionati, Y=visibili con filtri attuali
• Campo Ricerca: Filtra in tempo reale per ID, nome centrale, CLLI
• Bottone "Tutti": Seleziona tutti i collegamenti visibili; richiede una conferma prima di procedere, poiché la sincronizzazione di mappa e tabella può richiedere alcuni secondi.
• Bottone "Nessuno": Deseleziona tutti
• Bottone "Select" (Azzurro): Toggle per mostrare SOLO collegamenti selezionati
  Click 1: Mostra solo selezionati • Click 2: Mostra tutti (con filtri applicati)
• Lista Scrollabile: Max altezza 135px, scroll automatico se più elementi

Informazioni per Ogni Collegamento

Linea 1: ID – Centrale A → Centrale B ✓ (se selezionato)
Linea 2: Distanza km • Zona • Regione • Stato
Colorazione Stato:
• Verde = ATTIVO
• Rosso = NON_ATTIVO
• Giallo = IN_ATTIVAZIONE
• Arancione = IN_VARIAZIONE
• Blu = IN_REINSTRADAMENTO

Interazioni

Click su Collegamento: Seleziona/deseleziona + zoom automatico sull'area
Evidenziazione Selezione: Sfondo azzurro + bordo sinistro blu
Ricerca: Digita testo → lista filtra istantaneamente
Ricerca Avanzata (Modalità Blocco): Digita più ID separati da virgola/punto e virgola
Esempio: "105, 157, 203" → mostra solo questi 3 collegamenti

Componenti Tabella

• Contatore: "X / Y" dove X=selezionate, Y=visibili
• Campo Ricerca: Filtra per nome centrale, CLLI, coordinate parziali
• Bottone "Tutti": Seleziona tutte le centrali visibili; richiede una conferma prima di procedere, per evitare selezioni massive involontarie e possibili attese durante l’aggiornamento di mappa e tabella.
• Bottone "Nessuno": Deseleziona tutte
• Bottone "Select" (Azzurro): Toggle per mostrare SOLO centrali selezionate
• Lista Scrollabile: Ordinamento alfabetico automatico per nome

Informazioni per Ogni Centrale

Linea 1: Nome Centrale ✓ (se selezionata)
Linea 2: CLLI • Lat XX.XXXX • Lon YY.YYYY
Evidenziazione: Se selezionata → sfondo rosa + bordo rosso

Interazioni

Click su Centrale: Seleziona/deseleziona + map pan/zoom su quella sede
Zoom Automatico: Livello 10 su centrale selezionata
Evidenziazione Collegamenti: Tutti i link connessi a quella centrale si evidenziano
Ricerca Multipla: Digita parte di nome comune (es: "ROMA") → vedi tutte centrali con "ROMA" nel nome

➕ ➖ Zoom In / Out

Funzione: Incrementa/decrementa livello zoom (1-18)
Equivalente: Scroll wheel mouse / pinch-to-zoom touch
Livelli Utili:
• Zoom 6: Vista Italia completa
• Zoom 10: Regione/provincia
• Zoom 14: Città dettaglio
• Zoom 18: Livello strada singolo edificio

🇮🇹 IT - Reset Vista Italia

Funzione: Torna istantaneamente a vista default
Parametri Reset:
• Centro: LAT 41.887, LON 12.549 (Centro Italia)
• Zoom: Livello 6
Quando Usare: Se ti sei perso in zoom profondo e vuoi tornare a overview nazionale

📏 Strumento Misura

Funzione: Attiva modalità misura distanze
Procedura:
1. Click icona 📏
2. Click primo punto su mappa
3. Click secondo punto
4. Appare linea rossa tratteggiata con distanza
5. Opzionale: continua click per misura multi-segmento
Precisione: Calcolo Haversine (±0.5%)
Unità: Kilometri (km) con 2 decimali

🗑️ Cancella Misure

Funzione: Rimuove tutti i segmenti di misura dalla mappa
Effetto: Istantaneo, non reversibile (no undo)
Nota: Non cancella collegamenti o nodi, solo misure manuali

🔍 Zoom Selezione

Funzione: Auto-zoom su elementi correntemente selezionati
Algoritmo: Calcola bounding box di tutti nodi/link selezionati, poi fit map
Padding: Automatico 50px per evitare elementi ai bordi
Quando Usare: Dopo selezione multipla per focus area
Prerequisito: Almeno 1 collegamento o centrale deve essere selezionato

🗺️ Zoom All

Funzione: Auto-zoom su TUTTI elementi visibili (rispetta filtri)
Differenza vs Zoom Selezione: Ignora selezione, usa visibilità
Esempio Uso:
• Filtri attivi: Area SUD + Stato ATTIVO
• Click "Zoom All"
• Risultato: Mappa si adatta per mostrare tutto il SUD con link attivi
Tip: Combina con filtri per viste personalizzate rapidamente

🔄 Reset All

Funzione: Reset completo interfaccia a stato default
Cosa Viene Resettato:
• ✅ Tutti filtri Stato → tutti ON
• ✅ Tutti filtri Area → tutti ON
• ✅ Tutti filtri Zona → tutti ON
• ✅ Filtro Arco → tutti ON
• ✅ Selezioni collegamenti → tutte OFF
• ✅ Selezioni centrali → tutte OFF
• ✅ Campo ricerca Collegamenti → vuoto
• ✅ Campo ricerca Centrali → vuoto
• ✅ Misure sulla mappa → cancellate
• ✅ Vista mappa → Italia centro zoom 6
• ✅ Marker geocoding → rimosso
• ✅ Percorsi stradali visualizzati → cancellati
⚠️ NON Resettato: Preferenze browser, history, bookmark
Best Practice: Usa Reset All all'inizio di ogni nuova sessione di lavoro

🏠 Ricerca Indirizzo (Forward Geocoding)

Input: Indirizzo testuale (strada, città, CAP, landmark)
Engine: Nominatim (OpenStreetMap)
Procedura:
1. Click campo "Ricerca Indirizzo"
2. Digita indirizzo (es: "Via Roma 10, Milano")
3. Premi Enter o click 🔎
4. Mappa si centra su indirizzo trovato
5. Marker rosso appare sul punto
6. Coordinate nei campi LAT/LON si aggiornano
Tips per Risultati Migliori:
• Includi sempre città: "Piazza Duomo, Milano" meglio di solo "Piazza Duomo"
• Usa CAP per disambiguare: "Via Roma, 20100 Milano"
• Landmark famosi funzionano: "Colosseo Roma", "Torre di Pisa"
Limitazioni:
• Indirizzi molto nuovi potrebbero non essere nel DB OSM
• Zone rurali hanno copertura minore
• Formattazione italiana richiesta (no indirizzi US-style)

📍 Ricerca per Coordinate (Reverse Geocoding)

Input: LAT e LON numerici
Formato: Decimal Degrees (DD) - esempio: 45.4642, 9.1900
Procedura:
1. Click campo LAT
2. Inserisci latitudine (range valido Italia: ~36 to ~47)
3. Click campo LON
4. Inserisci longitudine (range valido Italia: ~6 to ~19)
5. Click ➤ (freccia) o premi Enter
6. Mappa si centra su coordinate
7. Marker rosso appare
Precisione:
• 4 decimali: ±11 metri
• 5 decimali: ±1.1 metri
• 6 decimali: ±11 cm
Validazione:
• LAT fuori range → errore o default a centro Italia
• LON fuori range → errore
• Formato errato (es: lettere) → ignore o default

🌐 Display Coordinate Real-Time

Funzione: Campo "Ricerca Indirizzo" mostra sempre coordinate centro mappa
Aggiornamento: Real-time mentre trascini/panori la mappa
Uso:
• Sposta mappa su punto di interesse
• Leggi coordinate nel campo
• Copia per uso in altri tool (GPS, GIS, etc.)
Formato Display: "LAT: XX.XXXXXX, LON: YY.YYYYYY"

🔢 Algoritmo di Ricerca

Step 1: Calcola distanza Haversine da punto query a tutte le 124 centrali
Step 2: Sort centrali per distanza crescente
Step 3: Prendi top 3
Step 4: Per ogni top 3, query OSRM per routing stradale
Step 5: Display risultati con dual metric (aerea + stradale)
Performance: ~1-2 secondi totali su connessione media
Fallback: Se OSRM fail, mostra solo distanza aerea

📊 Interpretazione Output

Distanza Aerea (Linea Rossa Tratteggiata):
• Rappresenta shortest path "as the crow flies"
• Utile per: calcolo latenza fibra, rough estimate costi
• Limitazione: Ignora ostacoli (montagne, fiumi, proprietà private)

Distanza Stradale (Linea Blu Continua):
• Rappresenta percorso effettivo con strade reali
• Utile per: logistica installazione, tempo viaggio tecnici
• Include: curve, salite, limiti velocità stradali

Rapporto Stradale/Aerea (Indice di Tortuosità):
• <1.2: Percorso quasi rettilineo (ideale)
• 1.2-1.4: Percorso ragionevole (normale)
• 1.4-1.6: Percorso tortuoso (attenzione)
• >1.6: Percorso molto tortuoso (problematico, possibili ostacoli significativi)

☑️ Mostra Marker Centrali

Funzione: Toggle visibilità dei marker circolari sulle centrali
Default: ON (marker visibili)
Quando Disattivare:
• Mappa troppo affollata con 124 marker
• Performance lenta (device vecchi)
• Focus solo su collegamenti, non su nodi
Effetto OFF: Centrali spariscono visualmente, ma collegamenti rimangono

☑️ Mostra Collegamenti Non Selezionati

Funzione: Toggle visibilità collegamenti non selezionati
Default: ON (tutti collegamenti visibili)
Quando Disattivare:
• Hai selezionato subset specifico e vuoi focus SOLO su quello
• Ridurre clutter visivo
Effetto OFF: Solo collegamenti selezionati (con ✓) rimangono visibili
Combinazione Potente: OFF + "Select" nella tabella = vista ultra-pulita

☑️ Evidenzia Nodi Connessi

Funzione: Quando selezioni collegamenti, evidenzia automaticamente nodi terminali
Default: Dipende da implementazione (solitamente ON)
Effetto ON: Centrali agli estremi di link selezionati cambiano colore/dimensione
Uso: Visualizzazione rapida topologia: quali nodi sono hub critici
Nota: Non seleziona i nodi nella tabella Centrali, solo evidenziazione visiva
✅ Fix 05/12/2025: Ora funziona correttamente con tutti i database (DB RC, DB RA, DB RA+RC)

Informazioni Visualizzate

Formato DD (Decimal Degrees):
• Lat: XX.XXXXXX°
• Lon: YY.YYYYYY°
Formato DMS (Degrees Minutes Seconds):
• Lat: XX° YY' ZZ" N/S
• Lon: XX° YY' ZZ" E/W
Aggiornamento: Real-time seguendo mouse
Precisione: 6 decimali (±11 cm)

Uso Pratico

Identificazione Rapida Posizione:
• Muovi mouse su punto di interesse
• Leggi coordinate istantaneamente
• No need per click o geocoding
Export Coordinate:
• Hover su punto
• Leggi coordinate nel tracker
• Scrivi manualmente o screenshot
Verifica Centrali:
• Hover su marker centrale
• Controlla coordinate nel tracker
• Confronta con valori in tabella Centrali

⚠️ Troubleshooting Generale

Problema: Tool Lento
→ Disattiva "Mostra Marker Centrali"
→ Chiudi altre tab browser
→ Usa Chrome/Firefox (no IE/Edge vecchi)

Problema: Mappa Non Si Carica
→ Verifica connessione internet
→ Refresh page (F5)
→ Clear cache browser

Problema: Coordinate Sbagliate
→ Verifica formato: LAT deve essere ~36-47, LON ~6-19 per Italia
→ Se invertiti: swap manualmente
→ Confronta con Google Maps

Problema: Percorso Stradale Non Appare
→ OSRM potrebbe essere temporaneamente offline
→ Attendi 30 sec e riprova
→ Fallback: usa distanza aerea × 1.3 come stima

Problema: Non Trovo Collegamento X
→ Verifica filtri attivi (Area, Zona, Stato, Arco)
→ Click "Reset All" e riprova
→ Cerca per ID numerico invece di nomi

Problema: Select (Azzurro) Non Funziona
→ Verifica di aver selezionato almeno 1 elemento prima
→ Deseleziona tutto e riprova
→ Refresh page se persiste

File Sorgente (Excel)

DB RC (Backbone):
• RC_Italia_Nodes.xlsx - Centrali rete backbone
• RC_Italia_Links.xlsx - Collegamenti rete backbone

DB RA (Access):
• RA_Italia_Nodes.xlsx - Centrali rete accesso
• RA_Italia_Links.xlsx - Collegamenti rete accesso

File Output (JSON)

Generati dalla conversione:
• db1_nodes.json - Nodi RC (backbone)
• db1_links.json - Link RC (backbone)
• db2_nodes.json - Nodi RA (access)
• db2_links.json - Link RA (access)

Nomenclatura:
• DB1 = RC Italia (Backbone/Core)
• DB2 = RA Italia (Access/Aggregation)

Test Completo Post-Update

1. Verifica DB MERGED:
• Clicca "📊 DB RA+RC" (bottone viola)
• Verifica che contatori siano somma logica dei due DB
• Controlla che nodi duplicati abbiano _source: 'BOTH'

2. Test Etichette Tipo Rete:
• Usa "🏢 Centrali Vicine" in modalità MERGED
• Verifica che le etichette mostrino correttamente:
    • RC_Italia Core per centrali solo RC
    • RA_Italia Aggregation per centrali solo RA
    • Aggregation • Core per centrali in entrambi

3. Test Funzionalità:
• Filtri per zona/area
• Selezione collegamenti
• Zoom e navigazione mappa
• Calcolo percorsi stradali

Problemi Comuni e Soluzioni

Problema: Coordinate non valide
→ Verifica formato: LAT 36-47, LON 6-19 per Italia
→ Usa punto decimale, non virgola
→ Rimuovi spazi extra

Problema: CLLI duplicati
→ Ogni CLLI deve essere univoco nel DB
→ Controlla con formula Excel: =COUNTIF(A:A,A2)>1

Problema: Link orfani
→ Verifica che FROM e TO esistano nella lista nodi
→ Case-sensitive: "RMCNTL01" ≠ "rmcntl01"

Problema: JSON malformato
→ Usa validatore JSON online
→ Controlla virgole finali e parentesi
→ Encoding UTF-8 senza BOM

Problema: Mappa vuota dopo update
→ Apri Console Browser (F12)
→ Cerca errori JavaScript rossi
→ Verifica che arrays non siano vuoti

Schema Nodo (Node)

{
  "id": "CENTRALE_001",
  "name": "Milano Centrale",
  "clli": "MLNOITXA",
  "lat": 45.4642,
  "lon": 9.1900,
  "zona": "LO",
  "region": "Lombardia"
}

Schema Collegamento (Link)

{
  "id": "LINK_001",
  "from": "MLNOITXA",
  "to": "RMCNTLXA",
  "distance": 573.2,
  "state": "ATTIVO",
  "zona": "LO",
  "region": "Lombardia",
  "arco": "Dorsale_Nord_Sud"
}